Software 


@ Converting EO S Data From 
HDF-EOSto netCDF 

A C-language computer program ac- 
cepts, as input, a set of scientific data and 
metadata from an Earth Observing Sys- 
tem (EOS) satellite and converts the set 
from (1) the format in which it was cre- 
ated and delivered to (2) another format 
for processing and exchange of data on 
Earth. The first-mentioned format can 
be either HDF-EOS 2 or HDF-EOS 5 
("FI DF" signifies "FI ierarchical Data For- 
mat”). The second-mentioned format is 
netCDF ("CDF” signifies "Common Data 
Format”), which is an open-standard, 
machine-independent, self-describing 
format for scientific-data files. In the ab- 
sence of this or a similar program, in- 
compatibilities among the three file for- 
mats can cause loss of metadata upon 
conversion. 

This program preserves as many of the 
metadata as possible upon conversion. 
The program opensthe input FIDF-EOS 
2 or FI DF-EOS 5 file, queries the compo- 
nents of the file by use of the FI DF-EOS 2 
and FIDF-EOS 5 Compatibility Library 
(which is described in the immediately 
following article and provides uniform 
access to HDF-EOS 2 and HDF-EOS 5 
files), and writes the data and metadata 
components into a netCDF file following 
the Climate and Forecast (CF) metadata 
conventions. 

This program was written by Richard U li- 
man of Goddard Space Flight Center; Bob 
Bane of Global Science & Technology, Inc.; 
and Jingli Yang of Earth Resources Technol- 
ogy, Inc. Further information is contained in a 
TSP (see page 1). GSC-15007-1 


o HDF-EOS 2 and HDF-EOS 5 
Compatibility Library 

The HDF-EOS 2 and HDF-EOS 5 
Compatibility Library contains C-lan- 
guage functions that provide uniform 
access to HDF-EOS 2 and HDF-EOS 5 
files through one set of application pro- 
gramming interface (API) calls. ("HDF- 
EOS 2" and "H DF-EOS 5” are defined in 
the immediately preceding article.) 
Withoutthislibrary, di ff eren ces between 
theAPIsof HDF-EOS2and H DF-EOS 5 
would necessitate writing of different 
programsto cover H DF-EOS 2 and HDF- 
EOS 5. The API associated with this li- 
brary is denoted "he25.” 


For nearly every H DF-EOS 5 API call, 
there is a corresponding he25 API call. 
If a file in question is in the H DF-EOS 5 
format, the code reverts to the corre- 
sponding H DF-EOS 5 call; if the file is in 
the HDF-EOS 2 format, the code trans- 
lates the arguments to HDF-EOS 2 
equivalents (if necessary), calls the H DF- 
EOS 2 call, and retranslates the results 
back to H DF-EOS 5 (if necessary). 

This program was written by Richard U li- 
man of Goddard Space Flight Center; Bob 
Bane of Global Science & Technology, Inc.; 
and Jingli Yang of Earth Resources Technol- 
ogy, Inc. Further information iscontained in a 
TSP (seepage 1).G SC -15 008-1 


£ HDF-EOS Web Server 

A shell script has been written as a 
means of automatically making HDF- 
EOS-formatted data sets available via the 
World Wide Web. ("H DF-EOS” and vari- 
ants thereof are defined in the first of 
the two immediately preceding articles.) 
The shell script chains together some 
software tools developed by the Data Us- 
ability Group at Goddard Space Flight 
Center to perform the following actions: 
•Extract metadata in Object Definition 
Language (ODL) from an H DF-EOSfile, 
•Convert the metadata from ODL to 
Extensible Markup Language (XML), 
•Reformat the XML metadata into 
human-readable Hypertext Markup 
Language (HTML), 

• Publish the HTML metadata and the 
original H DF-EOS file to a Web server 
and an 0 pen-source Project for a N et- 
work Data Access Protocol (OPeN- 
DAP) server computer, and 

• Reformat the XML metadata and sub- 
mit the resulting file to the EOS Clear- 
inghouse, which is a Web-based meta- 
data clearinghouse that facilitates 
searching for, and exchange of, Earth- 
Science data. 

This program was written by Richard U li- 
man of Goddard Space Flight Center; Bob 
Bane of Global Science & Technology, Inc.; 
and Jingli Yang of Earth Resources Technol- 
ogy, Inc. Further information iscontained in a 
TSP (seepage 1). GSC-15011-1 


Q HDF-EOS 5 Validator 

A computer program partly automates 
the task of determining whether an H DF- 
EOS 5 file is valid in that it conforms to 


specifications for such characteristics as 
attribute names, dimensionality of data 
products, and ranges of legal data values. 
["HDF-EOS” and variants thereof are de- 
fined in "Converting EOS Data From 
HDF-EOS to netCDF" (GSC-15007-1), 
which is the first of several preceding arti- 
cles in this issue of NASA Tech Briefs.] Pre- 
viously, validity of a file wasdetermined in 
a tedious and error-prone process in 
which a person examined human-read- 
able dumps of data-file-format informa- 
tion. 

The present software helps a user to 
encode the specifications for an HDF- 
EOS 5 file, and then inspects the file for 
conformity with the specifications: First, 
the user writes the specifications in Ex- 
tensible Markup Language(XML) byuse 
of a document type definition (DTD) 
that is part of the program. Next, the por- 
tion of the program (denoted the valida- 
tor) that performs the inspection is exe- 
cuted, using, as inputs, the specifications 
in XML and the H DF-EOS 5 file to be val- 
idated. Finally, the user examines the out- 
put of the validator. 

This program was written by Richard U li- 
man of Goddard SpaceFlightCenter; Bob Bane 
of Global Science & Technology, Inc.; and 
Jingli Yang of Earth Resources Technology, Inc. 
Further information iscontained in a TSP (see 
pagel). GSC-15015-1 


fs XML DTD and Schemas for 
HDF-EOS 

An Extensible Markup Language(XML) 
document type definition (DTD) standard 
for the structure and contents of H DF-EOS 
files and their contents, and an equivalent 
standard in theform of schemas, have been 
developed. ("HDF-EOS” and variants 
thereof are defined in the first two of four 
related articles immediately preceding this 
one.) More specifically, this standard de- 
scribes the structure and contents of a sin- 
gle H DF-EOS 5 file based on the H DF-EOS 
model as published in Volumes 1 and 2 of 
the HDF-EOS Library Users Guide. The 
DTD and schemas are easy-to-use represen- 
tations of a complex file format, enabling 
display of data in multiple ways 

By means of HDF5 XML software 
tools from the National Center for Super- 
computing Applications, the user can 
transform HDF5 files into XML files or 
vice versa. Inasmuch as HDF-EOS 5 files 
areH DF5 files, thesamesoftwaretoolscan 
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be used to (1) transform any H DF-EOS 5 
file into an XM L file or vice versa or (2) 
convert, into an H DF-EOS 5 file, anyXM L 
file that conformsto the DTD or schemas. 

This program was written by Richard U li- 
man of Goddard Space Flight Center; Jingii 
Yang of Earth Resources Technology, Inc.; and 
M uhammad Rabi of Global Science & Tech- 
nology, Inc. Further information is contained 
in aTSP (seepage 1). GSC-15016-1 


@ Converting From XML to 
H DF-EOS 

A computer program recreates an 
FI DF-EOS file from an Extensible 
Markup Language (XML) representa- 
tion of the contents of that file. ("FI DF- 
EOS" and variants thereof are defined 
in the first of five related articles that 
immediately precede this article.) This 
program is one of two programs written 
to enable testing of the schemas de- 
scribed in the immediately preceding 
article to determine whether the 
schemas capture all detailsof FI DF-EOS 
files. (The other program converts an 
FIDF-EOS file into an XML file.) This 
program uses a General Purpose Lan- 
guage (GPL) parser called "expat" to 
parse XML and control extraction of 
data from an input XM L file. 

This program was written by Richard U li- 
man of Goddard Space Flight Center; Bob 
Bane of Global Science & Technology, Inc.; 
and Jingii Yang of Earth Resources Technol- 
ogy, Inc. Further information iscontained in a 
TSP (seepagel). 
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$ Simulating Attitudes and 
Trajectories of Multiple 
Spacecraft 

A computer program called "42" simu- 
lates the attitudes and trajectories of multi- 
ple spacecraft flying in formation any- 
where in the Solar System. The rotational 
dynamics are represented by high-fidelity 
models of spacecraft, each comprising as 
many as three connected rigid bodies and 
containing asmanyasfour flywheel mech- 
anismsfor storing angular momentum for 
controlling attitude. The translational dy- 
namics are represented partly by Encke's 
method of orbit perturbation, which en- 
ables the use of a reference trajectory 
shared by multiple spacecraft and, in so 
doing, enables separation of gigameter- 
scale trajectory features from nanometer- 
scale formation adjustments to preserve 
the numerical accuracy needed for simu- 
lating precise multi -spacecraft formations. 

Other models include planetary 


ephemerides and models for solar-radia- 
tion pressure, effectsof the terrestrial mag- 
netic field, effects of the terrestrial atmos- 
phere, and non-spherical components of 
the geopotential. The program providesa 
graphical display that facilitates visualiza- 
tion of individual behaviors of, and inter- 
actions among, the spacecraft in a forma- 
tion. Models of spacecraft sensors, control 
laws, and control-actuator dynamics are in- 
cluded; these models can be customized 
(thiscan include linking to real flight soft- 
ware) to enable high-fidelity simulation. 

This program was written by Eric Stonek- 
ing of Goddard Space Flight Center. Further 
information is contained in a TSP (see page 
D.GSC-14817-1 


M Specialized Color Function 
for Display of Signed Data 

This Mathematica script defines a color 
function to be used with Mathematica's 
plotting modulesfor differentiating data at- 
taining both positive and negative values 
Positive values are shown as shades of blue, 
and negative values are shown in red. The 
intensity of the color reflects the absolute 
value of the data value. 

The quantization isthe same for both 
positive and negative values, so that com- 
parable intensities accurately reflect 
comparable data magnitudes. Cus- 
tomization is done through several soft- 
ware switches. The number of color bins 
to be used is selected by"nshades." "Lin- 
ear" is set to 1 for a linear mapping of 
data magnitudes to color, and set to Ofor 
nonlinear mapping. The nonlinear 
choice usesa cube root data-mapping to 
encompass a large data range while ac- 
centuating the smaller data values. This 
innovation allows nonlinear stretching 
of data to enhance visualization at the 
low end of the scale while still viewing 
the entire data range (the data range set 
by the user). 

This work was done by Virginia Kalb of 
Goddard Space Flight Center. For further in- 
formation, contact the Goddard Innovative 
PartnershipsOfficeat (301) 286-5810. GSC- 
15128-1 


Delivering Alert M essages to 
Members of a Work Force 

Global Alert Resolution Network 
(GARNET) is a software system for deliv- 
ering emergency alerts as well as less-ur- 
gent messages to members of the God- 
dard Space Flight Center work force via 
an intranet or the Internet, and can be 
adapted to similar use in other large or- 
ganizations. Messages can be presented 


in visible and audible forms on such di- 
verse terminals as desktop computers, 
portable alphanumeric pagers, tele- 
phones, fire alarms, and closed-circuit 
television. GARNET includes clientcom- 
ponents running on workers' desktop 
computers, and server components run- 
ning on redundant computers behind 
firewalls. 

An authorized user enters a message, 
selecting its degree of urgency and the 
group of intended recipients. The mes- 
sage i s th en d i ssem i n ated to th e red p i en ts 
along with a link to more-detailed infor- 
mation. GARNET can deliver a message 
by server push (in which it interrupts a 
user's work to present the message on the 
user's computer or other device) or client 
pull (in which a user's computer pol Is the 
server periodically). GARNET determines 
whether a given client receives alerts via 
client pull or server push when the client 
logs onto the server. To reduce network 
traffic, GARNET gives preference to 
server push. 

T his program was written by Julia L oftis and 
Stephanie Nickens of Goddard Space Flight C al- 
ter and M dissa Pdl and Vince Pdl of Science 
Systemsand Applications, Inc. Further informa- 
tion iscontained in a TSP (seepage 1). GSC- 
14927-1 


Q Delivering I mages for M ars 
Rover Science Planning 

A methodology has been developed 
for delivering, via the Internet, images 
transmitted to Earth from cameras on 
the Mars Explorer Rovers, the Phoenix 
Mars Lander, the Mars Science Labora- 
tory, and the Mars Reconnaissance Or- 
biter spacecraft. The images in question 
are used by geographically dispersed sci- 
entists and engineers in planning Rover 
scientific activities and Rover maneuvers 
pertinent thereto. 

The methodology, which effects a 
compromise among levels of image de- 
tail, fidelity, and delivery speed, com- 
bines image compression with an adap- 
tive level-of-d etai I image-delivery 
strategy that scales very well up to larger 
images that can include mosaic and 
high-resolution orbital images. In this 
methodology, images are tiled at multi- 
ple levels of detail. An image-browsing 
application program makes requests for 
tiles instead of entire images, thereby 
greatly accelerating delivery of images. 
At one extreme, a tile could contain a 
low-resolution representation of what 
originated as a large mosaic or high-res- 
olution image. At the other extreme, a 
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